Author: J. K. Patel
Date: 04/11/2024

Title: Description of setup details and files contained in the Section 3: RCF dataset.

This dataset contains the raw RCF scans, calibration data and RCF calibration analysis for the RCF data used in the results presented in Section 3 
of the article "A scintillating fiber imaging spectrometer for active characterisation of laser-driven proton beams".

See the main text of the article for details of the experimental setup.

The HDV2 type RCF was scanned using a Nikon Super CoolScan 9000 with 600dpi resolution. The calibration data was collected by scanning HDV2 films 
exposed to known doses of at the Birmingham MC40 cyclotron. This enabled cross-calibration of the scans of RCF exposed during the experimental work
presented in the main article.


Files:

./RawData/Shot0050_[1-5].tif
        These files are the raw scans of the exposed HDV2 RCFs.

./CalibrationData/RCF_Calibration_data.csv
        This file contains analysis of scanned HDV2 RCFs exposed to known doses of protons at the Birmingham M40 cyclotron.

./Analysis/RCF_calibration_analysis.py
        This analysis script used the calibration data to convert the pixel values from the scans of the RCF exposed on the experiment into absolute
        energy deposition. The calibrated RCF scans are written to the Calibrated_RCF_scans.pkl file for further analysis. This script was run using 
        Python 3.9.19, and uses python packages: numpy-1.24.3, pandas-2.0.3, scipy-1.9.3 and tifffile-2023.8.30.

./Analysis/RCF_calibration_analysis.ipynb
        This ipython notebook contains the same calibration analysis as in RCF_calibration_analysis.py, but can be run in an interactive manner, and 
        also generates Figure 5a) of the main article to illustrate the analysis process.

./Analysis/RCF_fiber_positions.pkl
        This file contains the positions of the regions-of-interest used to calculate the energy deposition in the RCF which corresponds to scintillating
        fibers in the SciFi BPM.
  
./Analysis/RCF_registration.pkl
        This file contains the offsets and rotations used to register the scans of each of the RCF layers to ensure each scan is represented in the same 
        Cartesian space.

